home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 018a / amac41.zip / COMT16.QM < prev    next >
Text File  |  1991-08-26  |  10KB  |  215 lines
  1. *                            COMT16.QM, v1.6c
  2. *                     Commenting/Uncommenting Macros
  3. *                        Written by Tom Hogshead
  4. *            With Macro Contributions by John Goodman, et al
  5. *                                8/15/91
  6. *  Key    Subfile              Description
  7. * =====  =========  =====================================================
  8. *                              New Macros
  9. *                              ----------
  10. * @(1)    {e:\up\rfr003}                                                  |new
  11. *                 --Formats Commented or Uncommented PARAGRAPH,
  12. *                       Leaves Commented Paragraph Uncommented,
  13. *                       and Vice Versa
  14. * @(2)    {e:\up\rfr003}                                                  |new
  15. *                 --Formats Commented or Uncommented PARAGRAPH,
  16. *                       Leaves Paragraph in Original Commented
  17. *                       or Uncommented State
  18. *--
  19. * ^(cursordown) {e:\up\com001}
  20. *                 --Comment or Un-Comment Line or Block With * in Col 1,
  21. *                       Blank Lines NOT Commented,
  22. *                       Pauses To Mark Block If Not Marked
  23. *                            (John Goodman and Tom Hogshead, Authors)
  24. * @(3)    {e:\up\com001}
  25. *                 --Comment or Un-Comment Line or Block With * in Col 1,
  26. *                       Blank Lines NOT Commented
  27. *                            (John Goodman and Tom Hogshead, Authors)
  28. * @(8)    {e:\up\com001}
  29. *                 --Comment or Un-Comment Line or Block With * in Col 1,
  30. *                       Blank Lines Are Commented,
  31. *                            (John Goodman and Tom Hogshead, Authors)
  32. * @(2)    {e:\up\com001}
  33. *                 --Comment or Un-comment With "*»" in Col 1,
  34. *                       Blank Lines NOT Commented,
  35. *»                      (like this)
  36. * @(1)    {e:\up\com001}
  37. *                 --Add/Delete '*-- ' in Front Of Commenting Line,
  38. *--                 (like this)
  39. * @(4)    {e:\up\com001}
  40. *                 --Center Macro Comment * -- <Comment> --*
  41. * @(7)    {e:\up\com001}
  42. *                 --Remove Macro Comment * -- <Comment> --*
  43. * @(F1)   {e:\up\com001}
  44. *                 --Comment Non-macro Portion Of File
  45. * @(5)    {e:\up\com001}
  46. *                 --Un-comment Non-macro Portion Of File
  47. * @(F5)   {e:\up\com001}
  48. *                 --Original Commenting Macro     (John Goodman, Author)
  49. * ^(F5_)  {e:\up\com001}
  50. *                 --Original Un-commenting Macro  (John Goodman, Author)
  51. * #(F5__) {e:\up\com001}
  52. *                 --Revised Original Goodman Un-commenting,
  53. *                       Checks Before Un-commenting
  54. * @(F2)   {e:\up\com001}
  55. *                 --Comment Paragraph or Block
  56. * #(F2__) {e:\up\com001}
  57. *                 --Builds A "Comment Box" For C Programmers,
  58. *                       (Tim Farley, Author)
  59. * @(F3)   {e:\up\com001}
  60. *                 --Comment Whole File
  61. * ^(F3_)  {e:\up\com001}
  62. *                 --Un-comment Whole File
  63. * #(F3__) {e:\up\com001}
  64. *                 --Center C Program Comment (Richard Blackburn, Author)
  65. *--
  66. * @(5)    {e:\up\com002}
  67. *                 --Make Macro Title Box
  68. * @(6)    {e:\up\com002}
  69. *                 --Copy Macro Title To Index
  70. * @(9)    {e:\up\com002}
  71. *                 --Remove Macro Title Box
  72. *--
  73. * #(F4__) {e:\up\com003}
  74. *       --Surround Column-Blocked Text With Box Of Desired Characters,
  75. *             (John Goodman, Author)
  76. *                                   ********
  77. *         (Box Drawn Around Outside *Border* Of Column Block, Juxtapose Text)
  78. *                                   ********
  79. * @(F4)   {e:\up\com003}
  80. *       --Erase Outside Border Of Column-Blocked Text and Collapse Text
  81. *         Surronding Block To Original Position Before Box Was Made,
  82. *             (John Goodman, Author)
  83. * @(F8)   {e:\up\com003}
  84. *       --Put Colon in Front Of "Rem" Lines For Faster Batch File Operation
  85. * ^(F7_)  {e:\up\com003}
  86. *       --Prepend Prompted Text To, or Delete Prompted Text From,
  87. *         The Beginning Of The Current or Blocked Line(s),
  88. *             (John Goodman, Author)
  89. * #(F7__) {e:\up\com003}
  90. *       --Prepend Prompted Text To, or Delete Prompted Text From,
  91. *         The Beginning Of The Current or Blocked Line(s),
  92. *         Initialize Find Prompt With Last Prompted Text
  93. *             (Tom Hogshead Modification Of ^F7)
  94. * @(F7)   {e:\up\com003}
  95. *       --Insert Text At Beginning Of All Blocked Lines,
  96. *             (John Goodman, Author)
  97. * @(8)    {e:\up\com003}
  98. *       --Insert Text at Beginning of Blocked Lines (or Current
  99. *         Line If No Blocks Marked), John Goodman, Author
  100. *--
  101. *         {e:\up\com004}  [ Reserved for later use ]
  102. *--
  103. * @(h)    Jump From Index Line To (Locate) Macro or Item in Document Below
  104. *
  105. *
  106. * (Index) - How to locate macro or item below from Index using @h
  107. * (Description)
  108. * (Startup)
  109. * (Macros)
  110. * (Other) Macros
  111. * (Version) history
  112. *
  113. *-- eoi
  114.  
  115. * (DESCRIPTION):  COMT16.QM contains macros to comment and un-comment
  116. * lines, blocks, paragraphs, macros, C programs, and dBase lines. Also
  117. * has macros to insert and delete text at beginning of lines or blocks,
  118. * macro to speed up batch file running, and macro to make and remove
  119. * boxes with any desired border surrounding text.
  120.  
  121. * (INDEX) USE: To locate a macro or item in this file, press @h, place
  122. * the cursor line on the desired item in the Index above, and press
  123. * <enter>. See BOOKxx.QM for more details.
  124.  
  125. * (STARTUP): To BEGIN, just type "START COMT" <Enter>. All pertinent
  126. * files will be loaded in the "Ring" for viewing, and COMT16.MAC is
  127. * read. Alternatively, type "START COMT 0" <Enter> and the disk copies
  128. * of all files in the "Ring" will be loaded ready for editing, saving
  129. * time.
  130.  
  131. * These macros require "QEdit and QMAC v2.1, February, 1990" or later.
  132. * For (other) macros, see ALLMACRO.INF.
  133.  
  134. * (MACROS)
  135. * ---------
  136. *  See subfiles 'com00x.qm' for macros.  Use @f in BOOKxx.QM to access
  137. *  macros.
  138.  
  139. * 
  140. * ----------------------------------------------------------------------
  141. * @(h)  Jump From Index Line To (Locate) Macro or Item in Document Below
  142. * ----------------------------------------------------------------------
  143.  
  144. *        Alt_h can be used to quickly jump from Index Line to the desired
  145. *        item or macro in the document below:
  146.  
  147. *        1. Press Alt and h at the same time. Line 1 is marked to
  148. *           highlight. Cursor down to desired line in Index.
  149.  
  150. *        2. Press Enter. The macro then locates and jumps to the item
  151. *           selected on the cursor line in the document below.
  152.  
  153. *   See BOOKxx.Qm and JMPPOSxx.QM in AMACxx.ZIP for more discussion about
  154. *   using bookmarks and positions markers ( ) to jump to positions in
  155. *   files.
  156.  
  157. @h macrobegin
  158.         unmarkblock                     * Unmark any marked blocks
  159.         defaultwordset                  * in case altwordset on
  160.         begfile                         * Go to file begin
  161.         markline markline               * and highlight line 1
  162.         pause                           * Pause for Index selection
  163.         wordright markword              * Mark first word on line
  164.         copy                            * Copy word to scrap
  165.         endpara                         * Go to end of Index
  166.         makectrofscreen                 * Cursor line center of window
  167.         find "(" paste ")"
  168.         return "I" return               * Find first marked word in doc
  169.         jfalse NOMARK:
  170.         begline                         * If mark found, go to begline
  171.         jump END:
  172.         NOMARK:
  173.         begfile                         * if no mark found, go to begfile
  174.     END:
  175. *
  176. * 33 bytes Wed  07-10-1991  10:11:24 (TH @1 in BOOKxx.QM)
  177.  
  178.  
  179. * (Version) History;
  180. *
  181. *   1.0 -   Initial
  182. *   1.1 -   Modified @5, @6 and @9 to handle multi-line titles.
  183. *       -   Added ^F7, #F4 and #F7
  184. *       -   Added @2 and @3
  185. *   1.2 -   Shortened #F4 from 92 to 67 bytes. Handles full documents OK.
  186. *       -   Modified @9 to remove macro title box if marked with JMPPOS.
  187. *   1.3 -   Shortened #f4 from 67 to 49 bytes. Added alternate version
  188. *           written by John Goodman.
  189. *   1.4 -   Added new #F4 written by John Goodman.
  190. *   1.4a-   Changed description of @2.
  191. *   1.5 -   Modified @8 description.
  192. *       -   Changed ^F6 key to #F5.
  193. *       -   Modified @5 to put position marker on top of box and pause to
  194. *           select title lines.
  195. *       -   Added @1 to Add/Delete '* -- ' in Front of Commenting Line, Like         <new
  196. *-- this.
  197. *       -   Added latest version of @h.
  198. *       -   Added [ ^cursordown ] to comment/uncoment without having to mark
  199. *           block before macro execuction.  Column/Char/Line blocks OK.
  200. *   1.5a-   Moved begline up in [ ^cursordown ] to keep cursor in col 1.
  201. *       -   Included in AMAC38.ZIP, July 21, 1991.
  202. *   1.6 -   Modified ^cursordown per John Goodman, shortened 3 bytes to
  203. *           71 bytes, July 24, 1991.
  204. *   1.6a-   Added subfiles com001/002/003, July 26, 1991.
  205. *       -   Added @8 to com003, July 28, 1991.
  206. *       -   Included in AMAC39A.ZIP.                                   7/29/91
  207. *   1.6b-   Changed ^f1 in com001.qm to @5.                            7/30/91
  208. *                   (ver 1.6b in AMACxx.ZIP, v4.0)
  209. *   1.6c-   Added cross reference to macros in rfr003.qm.               8/6/91
  210. *           Modified @7 in com001.qm.                                   8/6/91
  211. *           Added com004.qm and com004.mac reserved for later use.      8/7/91
  212. *           Modified com003.qm documentation.                           8/8/91
  213. *           Added new macros @1 and @2 from rfr003.qm.                 8/15/91
  214. *
  215.